Автор перевода: Майкл "Antares" КлишинПредыдущая | Следующая | Оглавление

XML.firstChild

Доступность

Flash Player 5.

Синтаксис

my_xml.firstChild:XMLNode

Описание

Свойство, доступное только для чтения ; указывает на первый дочерний узел из списка дочерних узлов указанного родителя. Это свойство равно null в том случае, если у узла нет дочерних узлов. Свойство имеет значение undefined, если узел текстовый. Свойство доступно только для чтения и не может быть использовано для изменения дочерних узлов; используйте для этого методы appendChild(), insertBefore() и removeNode().

Пример

В примере ниже показывается, как XML.firstChild используется при обходе дочерних узлов:

// Создаем новый XML документ
var doc:XML = new XML();

// Создаем корневой узел
var rootNode:XMLNode = doc.createElement("rootNode");

// Создаем три дочерних узла
var oldest:XMLNode = doc.createElement("oldest");
var middle:XMLNode = doc.createElement("middle");
var youngest:XMLNode = doc.createElement("youngest");

// Добавляем узел rootNode как корневой узел в дерево XML документа
doc.appendChild(rootNode);

// Делаем каждый созданный дочерний узел дочерним узлом узла rootNode
rootNode.appendChild(oldest);
rootNode.appendChild(middle);
rootNode.appendChild(youngest);

// Используем firstChild при обходе дочерних узлов rootNode
for (var aNode:XMLNode = rootNode.firstChild; aNode != null; aNode = aNode.nextSibling) {
  trace(aNode);
}

// Выведет:
// <oldest />
// <middle />
// <youngest />

Пример ниже из FLA файла XML_languagePicker категории Examples и может быть найден в определении функции обработчика события languageXML.onLoad:

// Обходим строки в каждом узле, обозначающем язык
// добавляя каждую строку как новый элемент в массиве языков
for (var stringNode:XMLNode = childNode.firstChild; stringNode != null; stringNode = stringNode.nextSibling, j++) {
  masterArray[i][j] = stringNode.firstChild.nodeValue;
}

Чтобы увидеть весь скрипт, смотри файл XML_languagePicker.fla в папке HelpExamples:

См. также

XML.appendChild(), XML.insertBefore(), XML.removeNode()
Смотреть комментарии LiveDocs   Предыдущая | Следующая | Оглавление